<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      Net-tools-CVS_20101030
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;15.&nbsp;Networking Programs
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="ncftp.html" title="NcFTP-3.2.6">Prev</a>
          <p>
            NcFTP-3.2.6
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="nfs-utils.html" title=
          "NFS-Utils-2.4.3">Next</a>
          <p>
            NFS-Utils-2.4.3
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="netprogs.html" title=
          "Chapter&nbsp;15.&nbsp;Networking Programs">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="net-tools" name="net-tools"></a>Net-tools-CVS_20101030
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to Net-tools
        </h2>
        <p>
          The <span class="application">Net-tools</span> package is a
          collection of programs for controlling the network subsystem of the
          Linux kernel.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "http://anduin.linuxfromscratch.org/BLFS/net-tools/net-tools-CVS_20101030.tar.gz">
                http://anduin.linuxfromscratch.org/BLFS/net-tools/net-tools-CVS_20101030.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download (FTP): <a class="ulink" href=
                "ftp://anduin.linuxfromscratch.org/BLFS/net-tools/net-tools-CVS_20101030.tar.gz">
                ftp://anduin.linuxfromscratch.org/BLFS/net-tools/net-tools-CVS_20101030.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 6be14ed473cacdd68edeaa9605adc469
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 288 KB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 7.0 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: less than 0.1 SBU
              </p>
            </li>
          </ul>
        </div>
        <h3>
          Additional Downloads
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Required patch: <a class="ulink" href=
                "http://www.linuxfromscratch.org/patches/blfs/svn/net-tools-CVS_20101030-remove_dups-1.patch">
                http://www.linuxfromscratch.org/patches/blfs/svn/net-tools-CVS_20101030-remove_dups-1.patch</a>
              </p>
            </li>
          </ul>
        </div>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/net-tools">http://wiki.linuxfromscratch.org/blfs/wiki/net-tools</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of Net-tools
        </h2>
        <p>
          <a id="net-tools-automate-example" name=
          "net-tools-automate-example"></a> The instructions below automate
          the configuration process by piping <span class=
          "command"><strong>yes</strong></span> to the <span class=
          "command"><strong>make config</strong></span> command. If you wish
          to run the interactive configuration process (by changing the
          instruction to just <span class="command"><strong>make
          config</strong></span>), but you are not sure how to answer all the
          questions, then just accept the defaults. This will be just fine in
          the majority of cases. What you're asked here is a bunch of
          questions about which network protocols you've enabled in your
          kernel. The default answers will enable the tools from this package
          to work with the most common protocols: TCP, PPP, and several
          others. You still need to actually enable these protocols in the
          kernel&mdash;what you do here is merely tell the package to include
          support for those protocols in its programs, but it's up to the
          kernel to make the protocols available.
        </p>
        <div class="admon note">
          <img alt="[Note]" src="../images/note.png" />
          <h3>
            Note
          </h3>
          <p>
            This package has several unneeded protocols and hardware device
            specific functions that are obsolete. To only build the minimum
            needed for your system, skip the <span class=
            "command"><strong>yes</strong></span> command and answer each
            question interactively. The minimum needed options are 'UNIX
            protocol family' and 'INET (TCP/IP) protocol family'.
          </p>
        </div>
        <p>
          The patch below cleans up the installation so that it does not
          overwrite the <span class="application">ifconfig</span> and
          <span class="application">hostname</span> programs that were
          installed in LFS.
        </p>
        <p>
          Install <span class="application">Net-tools</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class=
"command">patch -Np1 -i ../net-tools-CVS_20101030-remove_dups-1.patch &amp;&amp;
sed -i '/#include &lt;netinet\/ip.h&gt;/d'  iptunnel.c &amp;&amp;

yes "" | make config &amp;&amp;
make</kbd>
</pre>
        <p>
          This package does not come with a test suite.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make update</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <span class="command"><strong>sed -i '/#include
          &lt;netinet\/ip.h&gt;/d' iptunnel.c</strong></span>: This fixes
          build breakage with linux-4.8 headers.
        </p>
        <p>
          <span class="command"><strong>yes "" | make config</strong></span>:
          Piping <span class="command"><strong>yes</strong></span> to
          <span class="command"><strong>make config</strong></span> skips the
          interactive configuration and accepts the defaults.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">arp, ipmaddr, iptunnel, mii-tool, nameif,
              netstat, plipconfig, rarp, route, and slattach</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">None</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">None</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="arp" name="arp"></a><span class=
                    "term"><span class="command"><strong>arp</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is used to manipulate the kernel's ARP cache, usually to
                    add or delete an entry, or to dump the entire cache.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="ipmaddr" name="ipmaddr"></a><span class=
                    "term"><span class=
                    "command"><strong>ipmaddr</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    adds, deletes and shows an interface's multicast
                    addresses.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="iptunnel" name="iptunnel"></a><span class=
                    "term"><span class=
                    "command"><strong>iptunnel</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    adds, changes, deletes and shows an interface's tunnels.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="mii-tool" name="mii-tool"></a><span class=
                    "term"><span class=
                    "command"><strong>mii-tool</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    checks or sets the status of a network interface's Media
                    Independent Interface (MII) unit.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="nameif" name="nameif"></a><span class=
                    "term"><span class=
                    "command"><strong>nameif</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    names network interfaces based on MAC addresses.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="netstat" name="netstat"></a><span class=
                    "term"><span class=
                    "command"><strong>netstat</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is used to report network connections, routing tables,
                    and interface statistics.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="plipconfig" name="plipconfig"></a><span class=
                    "term"><span class=
                    "command"><strong>plipconfig</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is used to fine tune the PLIP device parameters, to
                    improve its performance.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="rarp" name="rarp"></a><span class=
                    "term"><span class=
                    "command"><strong>rarp</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is used to manipulate the kernel's RARP table.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="route" name="route"></a><span class=
                    "term"><span class=
                    "command"><strong>route</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is used to manipulate the IP routing table.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="slattach" name="slattach"></a><span class=
                    "term"><span class=
                    "command"><strong>slattach</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    attaches a network interface to a serial line. This
                    allows you to use normal terminal lines for
                    point-to-point links to others computers.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-22 10:52:07 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="ncftp.html" title="NcFTP-3.2.6">Prev</a>
          <p>
            NcFTP-3.2.6
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="nfs-utils.html" title=
          "NFS-Utils-2.4.3">Next</a>
          <p>
            NFS-Utils-2.4.3
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="netprogs.html" title=
          "Chapter&nbsp;15.&nbsp;Networking Programs">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
